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220_INTRODUCTION 


1) 


2) 


3) 


4) 


The NOS/VE Cycle 17 system consists of the 
operating system and product set features outtined 
In the NOS/VE 1.0 Software Availability Bulletin (SAB). 


The NOS/VE Cycle 17 system must be Installed using 

the release materials. (See the NOQS/VE 1.0 SAB» pages il 
and 12» for the !ist of the release materials.) 

NOS V2.2 Level 596 Operating System and Level 587 

for the Common Products must be Installed on the 

computer before installing NOS/VE Cycle 17 to compitete 
the dual state system configuration. 


It is necessary to understand this documents the NOS/VE 
Le SABs the NOS/VE Installation and Upgrade Manual 
(60463913)» and the NOS 2.2 Level 596 Operating System 
and Level 587 for the Common Preducts and related 
documants before installing NOS/VE Cycle 17. 


After installing NOS V2.2 Level 596 Cperating System 
and Level! 587 for the Common Products system and the 
NOS/VE Cycle 17 systems the NOS and NOGS/VE 

systems may be deadstarted and placed into operation. 


PSR numbers are Included with some of the items in this 


document. These PSRs are outstanding as of the date of 
the release. 
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)_EEAIURES_AND_ PRODUCTS 


A complete description of Operating System and Product Set 
features may be found in the NOS/VE 1.0 Software 
Availability Bulletin. Please refer to that decument for 
NOS/VE Cycle 17 system feature information. 


All references In the NOS/VE 1.0 SAB to the CYBER 170-835 
and CYBER 170-855 should be updated to Include the CYBER 
170-815, CYBER 176-8255 and CYBER 170-845. All references 
In the NOS/VE 1.0 SA8 to NOS 2.1 Level 588 should be 
modified to NOS 2.2 Operating System Level 596 and Commen 
Product Lavel 587. 
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~iINSTALLATION AND_ OPERATIONS NOTES 


Bada _NOS_Lostaliationo 
1) PASSON and IRHF both run out of the SYSTEMX accounts. Because 


of 


thiss the password must be set to SYSTEMX and the resource 


validations must be set to their maximum. 
PSR # NVOOGDO? 


2) The *UN=* parameter on the *SETVE* command must have Its 
resource validations set to the maximum. Failure to do 
thls can cause the deadstart Job to fail with *"PRU LIMIT? 


or 


MSRU LIMIT. 


PSR # NVOOOO2 


Bale2 NOSZVE_ Installation 


1) There is a timing problem/data sensitive bug that may 
occassionally cause the RESTOCRE_PERMANENT_FILE command to 
abort. If this occurss the operator should restart RESTGRE 
with the falling reel. If the problem doa@s not re~occurs 
only one file is fost. If the problem still occurss restart 
RESTORE again but with the reel that follows the failing 
reel. In the second cases all Flies on the tape following 
the point where the failure occurred are lost. 


2) Automated validation performed during an Instailation 
Deadstart creates a S$FAMILY_USERS file for the NVE family. 
If you subsequentiy reload permanent files to family NVE from a 
BACPF files, catalogs which were not defined in the automated 
validation cannot be accessed. Likenises any catalog information 
which has not been updated in the automated validation file is 
incorrect for tha catalogs restored using BACPF. The recommended 
sequence of events In which an Installation Deadstart can be 
performed, and the family NVE permanent Files restored from a 
previous level is as follows? 


1. BACPF all NVE catalogs and files (except 


uuusedSFAMILY_USERS) to tape (uuu is the FAMILY USER 
Administrator)... 
BACPF the file uuue-SFAMILY_USERS. 
This is done by bracketing the commands associated with 
the backup with TASKs TASKEND commands. The ring number 
Is established by using the RING parameter of the TASK 
command. For example: 

TASK RING=3 

COPYLFILE Input=aipha output=omega 
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3) 


4) 


5) 


6) 


TASKEND 
causes the COPY_FILE command to executa In ring 3-4 
NOTE: 
The task command can be specified only in an 
interactive job or in a batch Job running under 
SSYSTEM. 

3. Parform an Installation Deadstart of NOS/VE» but enter the 
command DETF VALIDATE/OFAMILY/ONVE prior to entering the 
NEXTDSTAPE response to the request for the first product 
tape. This command will disable automated validation. 

*%. Restore the $FAMILY_LUSERS File that was backed up In step 2. 
(If you failed to disable validation prior to this steps you 
must togin as the NVE familly user administrators and change 
the name of the $FAMILY_LUSERS file using Change_Catalog_Entry.) 

5. Restore the ramaining NVE family filles which were backed up 
in step l. 

6. Execute the Create _Fanily command from the operator console 
PSR NYOOO7S 


The procedure Verify Installed Software which is documented in 
the NOS/VE Installation and Upgrade manual (Publication number 
66463913 A) is not available at this time. 


The NOS User Name creation described in the NOS/VE Installation 
and Upgrade Manual iImplles that the default MOOVAL DS vatue is 
adequate. 0825 is the appropriate value. 


Multiple NOS/VE upgrades using the CREATE_JOB_TEMPLATE command 
result in a targe number of files being created on the deadstart 
disk. Each successful execution of the CREATE_JOB_LTEMPLATE command 
creates a directory file and several uniquely named segment files. 
The directory fille name Is specified by the TEMPLATE NAME 
paramaters and contains the name of every segment file which 
constitutes the job template. Whenever a Job tempiate is no Songer 
being used» the DELETE _JOB_LTEMPLATE command should be used to 
remove the directory file from the deadstart disk. Segment files 
are removed by this command whenever the directory file is removed. 
The console entry for this command is? 


KeDELETE/OJDB/OTEMPLATE TN=name 


Online manuals are reteased on a NOS/VE Backup _Permanent_Files tape 
at this release. This is an interim process that will be 

replaced by a process being generated by Publications and 
Integration. To installed the online manuals» you must 

reload the files on this tape into the $SYSTEM.MANUALS 

subcatalogs of the SSYSTEM family. Create the following 

NOS/VE job to accomplished this task: 


JOB 
request_magnetic_tape file=backup type=mt9$1600 ring=no evsn=nve007 


WHEN any_fauit 00 
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display _vaiue osvistatus output=$response 
request loperator_action messagez4 RESTORE FAILED - CHECK TAPE? 
logout 

WHENEND 


RESTORE _PERMANENT_LFILES 
restore _alicfiles backup _ file=backup 
QUIT 


JOBEND 


The above job may be created as a NOS or NOS/VE text File. This 
text file is then accessed from the operator consoles using the 
ATTACH_LFILE or GETLFILE commands and the INCLUDE_LFILE command is 
executed to submit this job as a SYSTEM Family batch Job. 


Upgrade installation specifying LOADFILES (through 
SETLSYSTEM_LATTRIBUTES) but not MULTPD causes the deadstart 
version of OCU rather than the standard version of 

CU to be generated. The SHIGH cycie must be DELF%d 
after the system Is up. 


The operating system requires assistance at the console for 
remote installation and ramote maintenance. The installation 
and maintenance procedures are being modified to reduce the 
need for assistance at the console but until Remote Deadstart 
Is avallabies this need will not be totally eliminated. 


Great care should be taken using the DELETE_LUSER subcommand 
of the ADMINISTER_LUSER utility. If more than 20 users 

are deleted since Installation of the systems there is a 
good chance ALL USERS WILL BE LOST. 

PSRs NVODNBI6,s NYOEDS], NYOEDSG2 


3e2-NOSLVE_Executive 


i) 


2) 


NOS/VE will not support nore than 10 tasks 

concurrently defined per job. The system does not 
enforce this fimit; users must be careful not to 

exceed this limit or they may cause the system to fail. 


To successfully terminate a Job that has an action message 
posted to assign a tape» the sequence must be as 
follows: 


KeASSIGNLDEVICE AT=nnnn STOP 
KeTERMINATE_JOB ce 


Failure to assign the device prior to terminating the 


job will cause the Job to hang. 
PSR NVOQE337 
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aad_Deerator. Commands 


1) Restarting Up IRHF and IFEXC on the 189 Side 


IRHF should automatically restart if it aborts. There Is 

a constant check to see if it has aborted. To bring up 

TIRHF manuallys the operator must first bring down IRHF, then 
bring it up again. The same holds true for PASSON. 


To bring down IRHFs type in at the 180 NOS/VE operator's 
console: 


KeDEACTIVATE_LSYSTEM_LTASKS TASK NAMES =RHINPUT 
Ke DEACTIVATELSYSTEM_LTASKS TASK NAMES =RHOUTPUT 


Then to bring IRHF back ups type In at the 180 NOS/VE 
operator's conso! a? 


Ke ACTIVATELSYSTEMLTASKS TASK NAMES =RHINPUT 
KeACTIVATELSYSTEM_TASKS TASK NAMES =RHOUTPUT 


To bring down IFEXCs type in at the 180 NOS/VE operator's 
console? 


Ke DEACTIVATELSYSTEM_TASKS TASK_LNAMES=IFEXEC 


Then to bring IFEXC back up» type in at the 180 NOS/VE 
operator's console: 


KeACTIVATE_LSYSTEM_TASKS TASK NAME#IFEXEC 
PSR NV9G632 
2) Restarting IRHF and PASSON on the 176 Side 


To make provisions for restarting IRHF and PASSON»s a site 
analyst or an operator should create two procedures and save 
each one on an Indirect permanent file that is located under 
user Index 3777778. 


Procedure 1. The file name should be MSSIRHF and shouid fock 
fike this: 


«PROC» MSSTRHF,. 

COMMON» SYSTEM. 
GTReSYSTEMsNVELIBsUSULIB/NVELIB 
UNLOADs SYSTEM. 

LISRARYsNVELIB. 

RUNJOBSCIRHF) 


Procedure 2, The file name sheuld be MSSPASS and should took 
like this: 
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oPROCsMSSPASS.. 

COMMONs SYSTEM. 

STRs SYSTEMS NVELIB,U.ULIB/NVELIB 
LIBRARY» NVELIB.. 

RUNJOBS(PASSON) 


Once these are in user index 3777778, IRHF is restarted by 
simply typing the folleulIng In at the 17€C operator's console: 


MSSIRHF. 

PASSON Is restarted by typing in at tre 170 operetor'’s console: 
MSSPASS. 

PSR NVOOO16. 


3) The NOS application (VETAF) that connects NOS/VE 
Jobs to NAM will sometimes produce the flashing 
console message: 


"PASSON ABNORMAL 18" 


This message means PASSON Is discarding an unsolicited 
message generated between VEIAF and the first read 
request from NOS/VE. 


This should be laonored. Clear the message with 'GODsjsn.! 


324_Configuration Management 


1) The INITIALIZE_DEADSTART_DEVICE system—-core command 
and the INITIALIZE_LMS_VOLUME Logical Configuration 
Utility subcommand do not warn the operator that the 
volume has been preaviousiy initialized. This ts of 
particular concern in INITIALIZE _MS_VOLUME because the 
operator may misspell! the element name of the device 
and Inadvertently destroy permanent files. 


2) If the physical configuration consists of one channels 
one mass storage controllers and one mass storage 
units one can describe this initially using 
system—core commands. Howevers this configuration 
needs to be redescribed using Physical Configuration 
Utility and Logical Configuration Utility subcommands 
in order to get through an installation deadstart. 


3) For optimal system performance ali NOS/VE disk units 
should be defined during the instal! deadstart. This 
is important so that all of the logical configuration 
is avallable for allocating product set files. 
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4) 


5) 


6) 


7) 


During recovery when operator intervention has been 
specifleds the logical configuration utility (LCU) is 

Invoked both before and after the configuration 

transition. The first invocation allows the operator 

to change which elements In the physical configuration 

are logicaily configured. The second invocation allows 

the operator to Initialize and add volumes to the system set. 
This is useful if the first Invocation of the LCU happens 

to add one or more volumes to the togical configuration. 


The ability to Invoke the LCU during a continuation deadstart 
as described in the previous bullet has been added. 


The physical configuration utility subcommands 
INSTALLUPHYSICAL_CONFIGURATION has a new parameter» 
PHYSTCAL CONFIGURATION. This parameter specifies 

the name of a local file that will recelve information 
about the physical configuration being debugged. Use 

of this parameter will cause the configuraticn to 

NOT be installed. The file produced by this command 

can be used as Input to the INSTALL_LOGICAL_CONFIGURATION 
subcommand of the togical configuration utility. 

The abbreviation for PHYSICAL_CONFIGURATION Is PC. 


The logical configuration utility subcommands 
INSTALLULOGICAL CONFIGURATION has a new parameter» 
PHYSICAL_CONFIGURATION. This parameter specifies 

the name of a local fife that will provide information 
about the physical configuration belng debugged. Use 
of this parameter will cause the configuration to 

NCT be instatled. The abbreviation for 

PHYSICAL CONFIGURATION Is PC. 


J22_Device Nanagement/Recovery 


a) 


If any disk votume being used by NOS/VE becomes fulls 
the following message will perlodically appear on the 
MDD screen: 


AAAAAA ~ volume out of space 
(AAAAAA is the vsn of the volume) 


Any task that is requesting space on a full volume 
will hang waiting for space. Some space may be 
obtained by asking users (If they are able) to detete 
permanent files and detach focal files. If the disk 
full condition persists» the NOS/VE system should be 
taken down and brought back upe This action will 
release most of the temporary file space that was In 
use. If the disk full was caused by permanent files» 
then the disk will be nearly full after the recoverys 
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1?) 


and some action--such as backing up permanent files 
and deleting some files—-must be taken Immediately. 


It is possibile that a disk full situation will occur 
that cannot be recovered. This will have happened if 
the “volume out of space" message appears during a 
deadstart before the system Is up. In this case 

case permanent file volumes must be Initliatized 

and reloaded from a previous backup dump. 


If a continuation deadstart falls after disk full with 

a 180 CPU monitor Faults it Is possible that the failure 
Is due to unprinted files in the output queues one or 
more of which are no fonger printable. The fallure is 

a job mode software failure and does not leave the MCR 
set In monitor modee The message indicating this 
failure is "HR = MONITOR FAULT®. 


Corrective action: 


On the next attempt at a continuation deadstarts enter 
the following command when the system asks for 
operator supplied core commands: 


SETLSYSTEM_LATTRISUTE HALTRING © 


This command wll! allow deadstart to complete. If» at 
this times you find that task RHOUTPUT has terminated 
(by looking at the systen Job log by doing a DISSL)» and 
files exist in the job output queue (DISPLAY CATALOG 
SSYSTEMSSJOB_LOUTPUT QUEUE) you can be reasonably sure 
that you have encountered this problem. 


Delete the contents of the job output queue (DELETE 
CATALOG _CONTENTS SSYSTEM.~SJOB_ GUTPUT_QUEUE)s terminate 
NOS/VE»s, and do another continuation deadstart. 


When recovering without a memory image» the EDI for a 
file is sat to the highest allocation-unIit which has 
been Initialized on the devicee This is probably not 
what the actual end-of-Information (EOI) shows In the 
memory image. The file's owner is not informed that a 
differant EDI has been chosen. This means that the user 
cannot use BAM to read the file. The file needs to be 
recreated, 

PSR NVOES5S24 


3eQ_Physical_120_{Tape) 


1) 


Tape support Is timtited to and intended for use only by 
the permanent file backup and restore utility. Use of 
tape I/0 for any other purpose may produce undefined 
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>) 


ius 4 


rasuits. 


When preparing to mount a tape to be read by NOS/VE»s the heads on 
the drive should first be cieaned. This is recommended before 
each tape mount due to the currenttiy incomplete imptlementetion of 
error recoverye 


3BeZ_Intecactive 


1) 


Yhen using X25 to access NOS/VEs a terminal may 
Intermittentiy hang allowing no Input or output. TIP 
commands break (such as escape-CH) out of this problem. 
This Is a CCP problem that has been PSRd and corrected 
PSR CC5A239 
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4,1_Systen Command Lanayage 


1) A&A command that depends on the "path name” for a flie 
is affacted if the file has been explicitly attached 
(attach _files create _file commands). 


The "path name™ that such a command will encounter Is 
the “focal path name" rather than the path specified 
when the command was called. For example: 


ATTACHLFILE SUSER.X LFN=Y 
REPLACE_LFILE $USER.X 


will result In a file called Y being referenced in 
real state rather than Xe. Users should not mix 
Implicit and explicit attaching of a file. 

PSR NVOD753 


2) The $PROGRAN function does not return the open 
position designator for the LOAD MAP file. 
PSR NVOD483 


3) The SETLSENSE_SWITCH (SETSS) command will not accept a 
"user supplied job name” but will only work when given 
a “system supplied job name". 
PSP NVOD871, PSR NY¥ODS388 


4%) The constants SMIN_LINTEGER and SMAX_INTEGER have 
values of —(2**48-1) and 2**48—1» respectively» 
rather than ~(2**63) and 2**63-1,. 

PSR NVODG6O9 


5) A new display _option has been added to the display catalog 
and display _catalojg entry commands. For the former command 
this display option is called CONTENT(S) or C3 and for 
the latter command it is called CYCLE(S) or Ce. Alsos a 
parameter called DEPTH has been added (following the output) 
parameter) to both commands that works in conjunction with 
the added disptay options. These options show the amount of 
space occupied by catalogss files» and cycles. The depth 
parameter determines the level of detail that is displayed. 


DEPTH=1 gives al tine summary of the catalog (or file). 
DEPTH=2 (the defalt) gives a breakdown of files and subcatatlogs 
contained directly in a catalog (or the cycies of a filled. 

A DEPTH greater than 2 Is onty applicable to catalogs and 
specifies a further breakdown of the catalogs and files 
contained within the subcatalogs of the catalog. To get 
complete Information about all subcatalogss files and cycles 
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contained in « catalogs specify DEPTH=ALL. These c nges 
did not make It into the manuals. 


Salal_Additional Commands._{Not_in Manuals) 
Selelal DISPLAY COUNAND. PARAMETER(S) (DLSCP) 


This command displays information about the parameters for 
a commande The information includes the names of the 
parameters» their types (including allowed keyword values) and 
thelr default values for an Indication that the parameter is 
reguired). 


This command Is not intended to be a replacement § for 
information in on~Jine manualss but rather a “memory jogger” 
for any command. It will work for any command that could be 
called at the point where this command Is called (including 
system supplied commands, SCL procedures» user programs and 
utility subcommands). 


This command can ba used to obtain Information about the 
parameters for any command that uses SCL services to parse its 
Narameterse 


display_command_parameters command=<command> 
Coutput=<file referenced] 
C[status=<status varlable>] 


command } coc: This parameter specifies the command for which 
information about parameters is sought. 


output {| o: This parameter specifies the file to which the 
parameter Information is written. Omission will cause 
SDUTPUT to be used. 


status: This is the standard status parameter, 


Selea2_Additional functions (Not_in Manuals) 
Sala2al _ SCOMMAND SOURCE 


This function is usad to datermine where the processor “for 
the requesting command was found. The source (file or 
cataiog) of the command is returned as a string. 


By its natures thts function Isn't particularty useful when 
used in thea expression for a parameter to a commands sinces in 
that casas it will return the source of that command. 
Therefore, this function its normally used In an assignment 
statement. 


~ COMPANY PRIVATE - 


14 
84/02/16 


SOFTWARE RELEASE BULLETIN 


NOS/VE (CYCLE 17) 


<S$command_source> ?:= SCOMMAND_ SOURCE [<4> <)>] 


Example: "The following proc resides on an™ 
"object library in some catalog." 
PROC samole command 
cs = $command source 
cat = S$path($fname(cs)» catalog) 
execute task Sfname(cat//%.sample program) 
PROCEND 


412202 S$2REViOUS_STATUS 


This function is used to obtain the completion status of 
the pravious command. 


€Sprevious_status> %*32= S$PREVINUS STATUS [£¢€1> <)>] 


Exampfe: collect text display status 
PROC display ustatuss diss { 
status? status = tprevicus status) 
display_value $value (status) 

PROCEND display status 
* 
create_variable s kind=status 
create _variable x status=s 
display status 
NORMAL STATUS 
craate_variable x status=s 
display _ustatus 
~-ERPROR=——- X Is already declared as a variable. 


4al0203 3QU0TE 
This function is used to quote a string. 
<$quote> 22= Z3QUNTE <> <string expr> <)> 
Example: s = PARC! DEF? 
g = $S$quote{s) 
display value 5s 
ABC *DEF 
display value a 
TABCTIDEF! 
Salha204_SSCAN_ANY 
This function is used to search a string for any one of a 
set of characters and return the index in the string of the 
found character. If no character from the set appears in the 
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<Sscanlany> 222 $SCANLANY (> <cher set> <»tsp> 
<string expr> <)> 


char set> %?3=2 <string exor> 


Example: digits = 01234567891 
s = TEMP 32? 
display vaiue $scan_any(digits»s 5) 
6 


eal a2. Sb _SSCAN_NOTANY 


This function is used to search ea string for any character 
that Is not In a set of characters and return the Index in the 
string of the found character. If only characters from the 
set appear in the strings zero is returned. 


C$scan_notany> 323 BQSCANLNOTANY <> <char set> <sisp> 
<string expr> <)> 


<char set> 33= <string exprd 


Examote: digits = 7901234567897 

s = 'TEMP_32! 
display_value $scan_notany(di gits»s s) 
1 


901222085 CAN_SIRING 


This function is used to search ai string for another 
strings called the patterns, and return the Index of the first 
character of the pattern in the string. If the pattern is the 
null strings one is returned. If the pattern is not found in 
the strings zero Is returned, 


€$scanustring> 2:32 SSCAN_STRING <> <patternd <sisp> 
<string exprd> <)> 


Coattern> t3= <string expr> 
Examples s = "123 abe_9? 


p = 'abct 
display value %scanustring(ps s) 
5 
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S$a102272_STRANSLAIE 


This function is used to change characters In a string 
according to a transtation table. The transtation table is a 
string of 254 characters which is utilized according to the 
Following algorithm. 


result = '? 
for | = 1 to $strien(string) do 

Ja = S0rd($substr (strings )) 

result = result // Ssubstr{tables, j+1) 
forend 


Two standard translation tables are provided. Use of 
LOWER_TO_LUPPER (LTU) produces a string with ail tower case 
letters transtated to thelr uprer case counterparts. Use of 
UPPER _TO_LLOWER (UTL) produces a string with ajll upper case 
letters transitated to thelr lower case counterparts. 


<ttranslate> %2= $TRANSLATE <> <transtation table> <sisp> 
<string expr> <)> 


€translation table> t3= <string expr>d 
$ LOWERLTO_LUPPER $ LTU 
; UPPER_TOLLOWER 3} UTL 
Example: display value $translate({lower_ to uppers '123_ abc!) 
123_A8C 
Sal02a8_ 37814 


This function Is used to remove trailing space characters 
from a string. 


<ttrim> s3= ETRIM <(> <string eaxprd <)> 
Example: s = *STRING ? 

display _value '<'/7s7/%>! 

<STRING > 

display value '<'*//$trim(s)/7/ >? 

<STRING> 
Sale.3.Additlonal Controt Statements (Not in Manuals) 


Salea3al_PUSd_ COMMANDS 


<push commands> %3:= PUSH COMMANDS 


The purpose of this statement is to cause the source (file 
or catalog) of the Issuing command to be pushed onto the top 
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af the “dynamic command fist". The entries tn the dynamic 
command tist are searched after the commands belonging to any 
active utilities and before the command fist entries 


manipulated 


by the SET LCOMMAND_LLIST command. Tha effect of 


this statement Is removed (popped) when the Issuing command 


terminates. 


Sa2_Permanent Elles 


1) 


2) 


The DISPLAY_CATALOG and DISPLAY UCATALOG_LENTRY 
commands, when used on a catalog or File owned by 
another users should only provide information for 
catalogs and/or files that the requesting user is 
permitted to access. This restriction is not 
enforced. The information erroneously provideds 
howevers does not Include passwords and onty contains 
log entries and permit entries that apply to the 
requesting user. 

NYOE2Z51 

NVQB133 


Great care should be taken using the DELETEUSER subcommand. 
of the ADMINISTERLUSER utitity. If more than 26 users 

are deleted since Installation of the systems there is a 
good chance ALL USERS WILL BE LOST. 

PSRs NVOD895» NVOEO6G1»s NVOEOG2 


423 Remote Host 


1) 


2) 


When the NOS/170 IRHF Its started via a DIS job (for 
debugging IPRHF)»s» It does not transmit queue files to 
NCS/VcE~« RUNJOBS is unable to acquire the aueue file 
from NOS/1790. . 

PSR NVODEZ92 


A method to work around the problem is to start IRHF with 
an unused “subsystem"™. An example would be to create the 
following PROC within the SYSTEMX catalog: 

PROC s"subsystem"IRHF 

COMMONs SYSTEM. 

GTReSYSTEMsNVELIB,U.ULIB/NVELIB 

UNLOADs SYSTEM. 

RUNJOBS CIRHF) 

REVERT. 
The following command could then be given to DSB. 

"subsystem” ITRHF 


When a bad LOGIN command is present in a batch jobs 
the job disappears and printout with the error is 
receivad by the user to report the probtem. This 
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occurs when sending a job from NOS to NOS/VE via 
ROUTEs xxsDC=LPs,FCH=RH,. 
NVOE491 


3) Change Information is not transmitted from NOS/VE 
side to the NOS side. 
PSR NVOOO19O 


4) Changing passwords on NOS and NOS/VE. 


In NOS 202» there are two passwords for each users 
One is the NOS interactive job password and the 
other is the NOS batch Joh password. The NOS 
interactive job password Is used while working on 

a terminal. It is also used for NOS/VE login 
processing —- when logging Into NOS/VE on an 
interactive terminals there is no check made of the 
NOS/VE password for validation purposess just the NOS 
interactive job password. Changing your NOS/VE 

will affect only your NOS batch password. Your 
NOS/VE password must match your NOS batch password 
otherwise Remote Host wiil not work since it submits 
batch Jobs to NOS. 


Note : When using the SET_LLINK_ATTRIBUTES commands 
the NOS/VE password specified must match the NOS 
batch job password. 


Note : The selection of passwords for NOS and NOS/VE 
must conform to the definition as given In the NOS 
Reference Manual for the NOS password and the NOS/VE 
Command Interface Reference Manual for the NOS/VE 
password. You have to take the common parts of both 
definitions to make a password that works for both 
NOS and NOS/VE. 


To change your NOS/VE passwords enter the SET PASSWORD 
command on the 180 side 3 


Setpw oldpw nenpw 


where oldpw is your current NOS/VE password and 
newow is the new password. 


To change your NOS batch job passwords you wil! 
have to submit a NOS batch job. Login to the 
170 side and create a file to submit this job. 
The file should contain the following 3 


JOBCARD. 
USER (Cusernams userpw) 
CHARGE» *. 
PASS WOR Cuser pws newpy) 
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END 


where usernam is your usernames userpw is your 
current NOS batch password, and newpw Is your 
new NOS batch password. Your original NOS batch 
password Is set to your original NOS interactive 
Job passwords. All of the above commands in the 
File created must be typed in capital letters. 


To submit this Jobs type in 3 
submitstfnsb. 
where Ifn is the file you created. 


In order to change your NOS interactive job 
passwords type in on the 170 side 3: 


passwnors ol dpwsnewpy. 


where oldpw is your current NOS interactive 
password and newpw Is your new Interactive 
job password. 


$a4_Pcrogram Nanagenpent 


1) Loading files into multipie rings may cause improper 
ring attributes to be assigned. 
PSR NVOC789 


2) The fiie position specifler is ignored when mentioned 
on SETPA. For examples specifying SETPA DEBUG _OUTPUT= 
SLIST.SEQNI will cause debug to overwrite the $LIST 
file from its BOI position (not ENI as expected). 

PSR NVEAD36 


4e3_Physical_I/0_ (Tape) 


1) Tape support is limited to and intended for use only 
by the permanent file backup and restore utility. Use 
of tape I/0 for any other purpose may produce 
undefined results. 


2) When preparing to mount a tape to be read by NOS/VE» the heads on 
the drive should first be cleaned. This is recommended before 
each tape mount due to the currently Incomplete Impilementetion of 
error recover ye 
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420_8asic_ Access. Method 


i) 


3) 


4) 


&) 


7) 


8) 


The SETLWORKING CATALOG (SETWC) command has no effect 
upon Files whose names are created within 
applications, For example? 


SETWC aJjl 
execute task 
task generates file name a 


The path name of the file Is not eajiea3 it is 
Slocaleae Only actual parameters of a command are 
subject to SETWC directions 

PSR NVEAOZ7T 


The preset_value file attribute is not supported, 
PSR NVOB204 


File attribute MIN RECORD LENGTH Is not set properly for 
record type F filles» MIN LRECORD_LLENGTH should be set to 
MAX_LRECORD_LENGTH if it is allowed to defaults but it Is 
currently defauiting to 0. This affects SORT/MERGE when 
the sort key is omitted and the default is taken. 

PSR NVOD398 


If more than 190 Instances of OPEN exist concurrently 
within a single tasks an ameSlocal file limit message 
is issued. The message indicates erroneously that 
162025 tocal. files is the limit which was exceeded. 
The message should say that. only 100 instances of open 
may axist concurrentiy in a taske 

PSR NVOD856 

PSR NVOD632 


Skipping forward/backward by records and partitions 

does not always report the encounter with boundary conditions 
with the correct exception condition. 

PSR NVYOED44 

PSR NVOD424 


Tf a FAP returns abnormal status to AMPSOPEN during an 

OPEN {(new)»s the File name Is still registered within 

the job and implicitiy created parmanent files are net 

purged. Recommend explicitly purging the permanent file. 
PSR NVOE1 50 


COPY_LFILE does not work on index sequential files when 
executed From with a task. 
PSR NVOE538 


File attributes that can be changed cannot be 
reassigned a NIL value. 


— COMPANY PRIVATE - 


21 
84/02/10 


SOFTWARE RELEASE BULLETIN 
NOS/VE (CYCLE 17) 
PSR NVEAQO3 


9) DETACHLUFILE returns FATAL abnormal status when a file 
is not known and causes a batch job to terminate. Use 
of the STATUS parameter to ignore the error is 
recommended. 

PSR NVOD618 


10) The SETLFILE_LATTRIBUTE command for an existing file 
accepts the specification of a preserved attribute 
even If it conflicts with the present one. No error will 
be saen and the preserved attribute will not be changed. 
PSR NVOC839 
PSR NVO0617 
PSR NVOD549 
PSR NVOD536 
PSR NVEAOD36 


11) When processing a COBOL READ REVERSE statament BAM 
fails to sat the file position to BOI and as a result the 
COBOL statement will loop indefinitely. 
PSR NVOED4S4 


12) COPY_FILE does not detect a copy to itself via circular 
Fille connections. 
PSR NVOE2Z86 


13) <Amptputlpartials with term_option = amc$terminates 
at file.position BOI» glves ‘unrecovered write error? 
on anew flie. Recommend using amptput partials with 
term_option = amc$start. 
PSR NVOD665 


14) Files impticitiy attached are not implicitiy detached, 
PSR NVOE322 
PSR NVOEZ9I4SH 


Se7_Loadec 


1) If a task adds a fibrary to the job's object library 
fist dynamic loads within that task will be unable to 
satisfy externals from the newly added librery. This 
espacially affects the usabllity of commands packaged 
in the Job monitor task because Jibraries added to the 
object tlbrary list by the system proiog cannot be used 
to satisfy externals of these commands. 

PSR NVYOEL75 


2) The default for the program attribute LOAD UMAP_OPTION 
Is set to NONE. This means a toad map will 
not be generated by EXECUTE_TASK unless the LOAD UMAP_OPTION 
parameter has been previously specified by a SET PROGRAM, 
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ATTRIBUTE command or explicitiy specified on the E CUTE_TASK 
command. 


The length of large data segments cannot exceed 
100,900,095 bytes (1.@e, 2%*27). 


4a3_lIoteractive 


1) 


2) 


3) 


4) 


If a user's terminal should become disconnected from NOS/VE»s 

the Job can be resumed by fogging in to the system and entering 
the command ATTACH JOR (CATTJ). The terminal will be reconnected 
to the jobs, and the job wlll be put Into e@ pause break state. The 
TERMINATE_COMMAND and RESUME_COMMAND commands can be used at this 


time with the same results as during a pause break. A DETACH JOB 


{DETJ) command has also been added to allow a user to detach a job 
by command. The DISPLAY_JOBLSTATUS command will display 
disconnected and detached jobs. Detached jobs will be 

terminated after a system defined time has elapsed. 


In order to use a CDC 72] terminal on NOS/VE»s the 
following command should be entered: 


SETLTERMINAL_LATTRIBUTES TC=T4610 


Access to NOS/VE (VEIAF) via a X25 connection will cause 
the terminal {and its NOS/VE job) to hang. The hang 
state can be cleared by entering any TIP commands 

such as escape-CH. Code to fix the problem in CCP is 
available and Is associated with PSR number CC5A230. 


NOS/VE R1.0.2 does not support an END-OF—INFORMATION (EOI) 
facility for Indicating to an interactive program that the 
user wishes to terminate interactive Input of data. The 

input must be ended by a count or by detaction of a particular 
input value. 

PSR NVGE484 


If an interactive job is using a display type terminal 
{CRT) and the page width terminal attribute is not set 
to exactly the page width of the terminals then 
overprinting of some lines will occur. To remedy this 
either set the page width correctly for the particular 
terminal or sat the cutput device attribute to printer. 


429_Job Management 


If the job reaches time limits the WHEN clause is 
repeatedly activated with normal status. If the 
whan contains a CONTINUEs then processing continues 
In an endless loop. 
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PSR NVOE337 


Sal_Interstate Communication 


In NOS 2.29 there are two passwords for each users 
Qne is the NOS Interactive Job password and the 
other Is the NOS batch Job password. The NOS 
interactive job password is usad while working on 

a terminal. It is also used for NOS/VE togin 
processing - when fogging into NOS/VE on an 
interactive terminals there Is no check made of the 
NOS/VE password for validation purposes» just the NOS 
Interactive job password. Changing your NOS/VE 
will affect only your NOS batch password. Your 
NOS/VE password must match your NOS batch password 
otherwise Interstate Communications wil! not work 
since it submits batch jobs to NOS. 


Note 3 When using the SETLLINK_LATTRIBUTES commands 
the NOS/VE password specified must match the NOS 
batch job password, 


Note : The selection of passwords for NOS and NOS/VE 
must conform to the definition as given In the NOS 
Reference Manual for the NOQS password and the NOS/VE 
Command Interface Reference Manual for the NOS/VE 
password. You have to take the common parts of both 
definitions to make a password that works for both 
NOS and NOS/VE. 


To change your NOS/VE passwords enter the SET_LPASSWORD 
command on the 180 side 3: 


Setpw oldpw newpw 


where oldpw is your current NOS/VE password and 
newpw is the new password, 


To change your NOS batch job passwords you wil! 
have to submit a NOS batch job. Login to the 
1790 side and create a file to submit this Job. 
The file should contain the fotlowing : 


JOBC ARO. 
YSERCusernams userow) 
CHARGE» *. 

PASS WOR Cuser pwsnewpw) 
END 


where usernam is your usernames userpw is your 
current NOS batch passwords and newpw Is your 
new NOS batch password. Your original NOS batch 
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password is set to your original NOS Interactive 
Job passwordse All of the above commands In the 
file created must be typed In capttal letters. 


To submit this Jobs type In : 
submits i fnsb. 
where Ifn is the file you created. 


In order to change your NOS interactive job 
passwords type in on the 170 side : 


passwors olidpwsnewpw. 


where oldoew is your current NOS Interactive 
password and newpw is your new interactive 
Job password. 


$211 213 2L AY BINARY LOG 
$a12a1_D1SPLAaY_ BINARY_LOG 


LISPLAY_SINARY_LOIG Is a command utility that processes the 
contents of the global binary logs ( statisticss accounting and 
engineering) into human- readable reports and graphs. There are 
no pre-packaged reports huilt into DISPLAY BINARY _LOG3 instead, 
user sub—commands specify the statistics to be extracted from the 
fog and the types of analysis to be performed. Input te the 
program may be elther an active system logs or a permanent file 
copy of a tog as produced by the Terminate _Log command. The 
information to be axtracted from the fogs and the type and format 
of the reports produceds Is specified by sub-commands supplied by 
the user. 


Saliaial_Ihe_Disalay_ binary. log Command 


POT disblupdt { 
Inputs I: LIST OF FILE 
types t: KEY statistics statisticss accounts.e. 
accountings engineering = statistic 
outputs o: FILE = $0UTPUT 
status ) 


This commands which may be abbrieviated DISBL,s enters the user 
into the command utility environmant. Subsequent sub-commands 
will be prompted for by the string "DISBL/". 


~ COMPANY PRIVATE - 


25 
SOFTWARE RELEASE BULLETIN 
84/02/10 
NOS/VE (CYCLE 17) 


The binary tog to be processed may be either ai currently-active 
system logs or a copy of a terminated tog. If an active tog Is 
to be useds the TYPE parameter specifies the desired system 
global logs and the INPUT parameter Is omitted. If a terminated 
loo is to be used» the INPUT parameter specifies the file names 
and the TYPE parameter is omitted. If a list of file names is 
provided for the INPUT parameters, the data wlll be processed as 
if the contents of these files are concatenated in the order that 
the files are specified. 


The TUTPUT parameter specifies the Pile on which the reports 
ganerated by DISPLAY_BINARY_LNG are written. <All current reports 
ere formatted for a page width of 132 columns. 


The first output page ganerated by DISPLAY_LBINARY_LOG tists the 
ineut files processed and the baginning and ending dates and 
times for each File. 


Sallelec_Definitlon sub-commands 


The user extracts data from the binary tog by first specifying 
one or more groups of statisticss and then specifying ene or more 
metrics (numbers expressing a measurement) to be derived from 
each groupe For examples, one group aight consist of the 
end-of-job statistic for each job run on the systems and an 
associated metric might be the CP time consumed for each Job. 


Final reports are generated through the use of a set of DISPLAY 
sub= commands. The particular DISPLAY sub-command used specifies 
the Porm of the report Chistograms statistical summarys etce)» 
and parameters to the sub- command specify the metric or metrics 
to be displayed» and additional Information about the form of the 
reporte 


To aconomize on execution times DISPLAY BINARY _LOG processes ali 
sub— commandss up te the QUIT sub-commands before generating any 
reports. The binary tog nead be scanned only oncey and aii 
reports are generated In parallel. They appear on the final! 
output files howavers in the order in which thelr sub~commands 
were Issued. 


As each group and metric is defineds it Is given a usar-chosen 
names which is subsequently used to refer to it. These names may 
be up to 31 characters in tengths and follow the usual SCL 
conventions for names. The group or metric [Identified by a given 
name need not be defined before the name is useds but must be 
defined before the QUIT sub-command that terminates the 
sub-command sete 
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POT defgipdt ¢ 
groupsg? NAME = SREQUTRED 
statistics si: NAME 
times t: RANGE OF time cvalue 
dates, d: RANGE OF date lvalue 
Job predecessor, jp: NAME 
task _pradecessors tp? NAME 
descriptive. datas dd: STRING 
betweans b: LIST 2 OF NAME 

) 


This sub-command defines a statistic groupe. The GROUP parameter 
supptiies ao name for this groups, and Is required. The other 
Parameters are all optional, and specify conditions which each 
statistic must satisfy before it wil! be part of the group. If 
two or more conditions are specifieds a statistic must satisfy 
all conditions svectifled before it wlll be Included in the group. 


The STATISTIC parameter specifies a statistic identifier. 
Statistic identifiers are of the form AANNNNN»s where AA Is two 
alphabetic characterss and NNNNN js ai decimal number. For 
examples, AV2600907 is a statistic emitted by the accounting and 
validation code at end-of-job,. 


The TIME and DATE parameters can be used to !imit the time period 
within which statistics will be recognized. The default renge of 
time is from 00:90:00 to 23:59:59. The default range of date is 
from O0/01/901 to 12/31/99. If only one value is specified for a 
parameters instead of a ranges then the provided vatue will be 
taken as the lower timit of the ranges and the default used for 
the upper limit. 


The NESCRIPTIVE_DATA parameter supplies a string which is matched 
against the contents of the descriptive data fieid in each 
statistic. Matching is performed character—by-character to the 
end of the parameter string. If the dascriptive data field in 
the statistic Is longer than the parameter strings the excess 
characters are ignored. 


The TASKUPREDECESSOR parameter Is used In combination with other 
paramaters on the DEFINE GROUP sub-command to relate two or more 
statistics issued by tha same task. The TASK PREDECESSOR 
condition is satisfied if the task Issuing the statistic also 
previously Issued another statistics, which is a membar of the 
group specified for the TASK PREDECESSOR parameter, 


For example: 


Define_group compile tasks statistic = PM23C0625 
descriptive data = 'FCPSCOMPILE_FORTRAN_ SOURCE? 
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Define group complle_end_of_task statistic. = PM23G0C0C3s e. 
task _predacessor = compile tasks t=08:00366..16:290:00» .. 
4=91/01/83..01/01/783 


These commands define a group called conuplie lend lof task that 
contains the and of task statistics for all FORTRAN compilation 
taskse 


The JOBLPREDECESSOR parameter is used In combination with other 
parameters on the DEFINE_GROUP sub—command to relate two or more 
statistics Issued by the same job. The JOS_PREDECESSOR condition 
is satisfied if the job issuing the statistic also previously 
Issued another statistics which Is ai member of the aroup 
specified for the JOBLPREDECESSOR parameter. 


The BETWEEN parameter is a future featuree It is currently 
accepteds but Ignored. 


Sellale2Za2_DEEINE METRIC Sub-command 


POT defmipdt ( 
metrics m3 NAME = S$REQUIRED 
groups g? NAME = $REQUIRED 
scale factors sf: INTEGER 
units u: STRING | 
counters c: INTEGER 1.2.63 
expressions e: STRING 

) 


This sub-command defines ai emetrice The METRIC parameter 
specifies ai name for this metrics and is required. The GROUP 
paramater is also requireds and specifies the group from whose 
members this matric is to be derived. 


The SCALE_LFACTOR parameter is used to adjust the values of the 
resulting matric In order to make them easier to understand or 
usee Each metric element is divided by SCALE. FACTOR before being 
used to generate reports. IF this parameter is not specified on 
the DEFINE METRIC sub-commands, a vaiue of 1 is used for the scale 
factor. 


UNIT ts an optional parameter that can he used to provide a 
string identifying the measurement unit associated with the 
values of this metric. If a unit is supplied», it is usad to 
tabel that metric in all output reports. If the UNIT parameter 
is not used, it defaults to blenks. 


The other parameters specify different ways in which a metric can 
be derived from the members of the group. One and only one of 
these parameters can be used In @ given DEFINE METRIC 
sub-command. 
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COUNTER specifies the Index of one of the 63 possible counters 
included in a statistic. The contents of the specified counter 
for each statistic In the group make up the resulting metric. 


EXPRESSION specifies an arithmetic expression that is evaluated 
to yield the value of each metric element. At presents the only 
expression that is. accepted by DISPLAY_LBINARY_LOG Is 1%. This 
expression is used to count the number of elements in a metric. 


4allele3_Diselay_Sub-commands 


This aroup of commands is used to specify reports to be written 
to the output file. As noted aboves ali commands are processeds 
up to the QUIT commands before any reports are actually 
generated. The reports appear on the final output file in the 
erder In which thelr sub-commands were Issued. 


Sallaia3dal DISPLAY SUMMARY Sub-command 


POT diss_pdt (¢ 
metrics mi NAME = SREQUIRED 
titles t: STRING 
) 


This sub-command requests a statistical summary reporte This 
report includes such Information as the means maximum and 
minimums, and total number of elements of the specified metric. 


The METRIC parameter specifias the metric to be reporteds and is 
required, 


The TITLE parameter may be used to provide a titie to be placed 
at the top of the report pagee If omitteds the metric name is 
usede ; 


4allaleaadea2_ DISPLAY _ OISTRIBUTION Sub-command 


POT disd ( 

metrics m3? NAME = $REQUIRED 

titles t : STRING 

fimitss Limits 1%: («€ Pls 12 ds € 135 914 ))3 INTEGER 

display_options do: KEY max _min_ bounds first umax centered», 
second max centered = max min bound 

K_intervals xi2 KEY selifladjusts, larges mediums small = 
selfladJjust 

) 


—- COMPANY PRIVATE = 


29 
SOFTWARE RELEASE SULLETIN 
84/02/10 
NOS/VE (CYCLE 17) 


This sub-command requests a distribution plots, which indicates 
the number of metric elemants with each value within the observed 
range. The report consists of a frame indicating X and Y axises» 
with the possible values of the metric on the X axiss and the 
element count on the Y axise ODISPLAY_LBINARY_LOG places asterisks 
within the frame to indicate how many metric elements had a 
particular value. The report also displays the number of 
elements within the frame and the number of elements which exceed 
the frame iimits . 


The functions of the METRIC and TITLE parameters are the same as 
in the DISPLAY_LSUMMARY sub-command. 


The LIMITS parameter can be used to define the frame boundaries. 
The defaults on the X-axis are the minimum and maximum of the 
contents in thea counter. On the Yraxiss the defaults are the 
minimum and maximum numbar of elements among X—- axis Intervals. 
First value set defines the X boundaries. Second set defines the 
Y boundaries. First value in each set defines the fower 
boundary. '=-1!' can be used to specified a default boundary, 


EXAMPLES: 
$={( 509 1099 )) X lower bound = 50s upper bound = 1000 
Y boundaries are default. 
t=(€ =-1ys 10900 )» X¥ lower bound = defaults upper bound = 1600 
{ 10, -1 )) Y Jower bound = 18s upper bound = defauit 


The DYSPLAY_OPTION parameter can be used to select first maximum 
or second maximum ( on Y-axis ) portion of the graphe 
FIRSTLMAX_CENTEREDs SECOND _MAX_CENTERED and MAX_UMIN BOUND are the 
keywords. The default of this parameter Is MAX _MIN_BOUND. 


The X_LINTERVAL parameter can be usad to determine the number of 
intervals into which the X-asis of the frame Is divided. 3 
different sizes are available: 


LARGE =- X-axis Is divided into 11 Iintervats; 
MEDIUM - X-axis is divided Into 21 intervals} 
SMALL ~- X—axis Is divided itnto 101 intervals. 


The default of this parameter is SELF_LADJUST. When default is 
useds the X— axis division will be depand on the X-axis ftimits 
alone. The rules are? 


X_ upper bound - X_JSower_bound <= 19 11 intervals 
Xuupper_bound - X_lower bound <= 500 21 intervals 
Xlupper bound ~- XUlower bound > 509 101 Intervals 
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1. The first and the fast intervals on the X axis are 
one~half the width of the other X axis intervais,. 


2 The X-axis upper ftimit as displayed may be slightly higher 
than the value specified in the subcommand. The rules are: 


11 intervals ( X upper —- X_tower ) modulus 10 = 9 
21 Intervals ( X_upper - X_lower ) modulus 20 = 9 
101 intervals { Xlupper - X_lower ) modulus 106 = © 


$adlele,323_DISPLAY TIME _OLSTREIBUTION_Sub-command 


POT distdpdt{ 
metrics mi: NAME = SREQUIRED 
metric limits» mit LIST 2.2.2 of INTEGER = S$REQUIRED 
titles ts STRING 
) 


This subcommand generates a graph which plots metric values 
against time. The X<axIs represents the time Intervals and the 
Y-axis represents the element counts of the metric. The 
asterisks placed within eaach time Interval represent the range of 
element values seen in that interval. The report also generates 
the number of elements within the frame and the number = of 
elements which exceed the frame limits. 


The METRIC parameter specifies the metric name to be reported. 
The METRICLLIMITS parameter specifles the limits to be used for 
the Yeaxis. The ftimits for the X-axis will come from the date 
and time parameters givan on the DEFINE GROUP subcommand. 


example: mi={9s5090) Y lower bound = 0 
Y upper bound = 506 


The TITLE parameter Is used to provide a titie to be placed on 


the top of the report pagee If omitteds the metric name will be 
usede 
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4.41212304_D015PLAY_DESCRIPTIVE. DATA Sub-conmang 


POT disdd pdt ( 
groups gi: NAME = $REQUIRED 
titles t: STRING 
) 


This sub_command processes the members of a groups rather than a 
metrice It displays valuas Cup to 256 characters tong) for the 
descriptive data fleld of each statistic In the groups together 
with tha number of times each value was encountered, 


The GROUP parameter specifies the group te be scanneds and is 
required. 


The TITLE parameter may be usad to specify a character string to 
be placed at the top of the first pege of the report. If it is 
not inctuded in the sub-commands then the name of the group is 
used Instead. 


S231012322_ DUMP GROUP. Sub-command 


PDT dumg_pdt { 
groups g: NAME = $REQUIRED 
counter formats cf: LIST 1.2263» 1222 range of INTEGER 1..63 
titles, t: STRING 
) 


This sub command processes the members of a group rather than a 
metric. Each statistic within the specified group is tisted In 
full. This group dump is particularity useful for debugging group 
specifications and statistic definitions. 


The GROUP parameter specifies the group to be dumpeds and is 
required. 


The COUNTER FORMAT parameter specifies in what base the counters 
will be displayed. The defauit base is 19, 
example: cf=((1.26910)9{ 9026358) ) 
Counters 1 - 8 will be displayad in base 10. 
Counters 9 ~ 63 will be displayed in base 8. 


The TITLE parameter may be used to specify a character string to 
be placed at the top of the first page of the dump. If it is not 
included in the DUMP_GROUP sub-commands the name of the group is 
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used instead. 


S$alleia4_GENERATE_ GROUP_EILE Sub=commandg 


POT gengf_pdt { 
group», 9g? NAME = $REQUIRED 
outputs, o3% FILE = $OyTPUT 
permanents p? BOOLEAN = FALSE 
) oe 


This sub _command selects a group of statistics defined by 
sub_command DEFINE GROUP» and writes the statistics to a legible 
file in a format suited for machine processing.e 


The GROUP parameter specifles the group to be selecteds and is 
required. 


The TTPUT parameter specifies the local file name which contains 
the selected statistics. If it ts not tnecluded in the 
sub_commands the name SOUTPUT is used as the defauit file name. 
The attributes of the output file wlll be: 


FILELCONTENTS = LEGISLE 
FILELORGANIZATION = SEQUENTIAL 
FILELPROCESSOR = UNKNOWN 
PAGE_LFORMAT = CONTINUOUS 
PAGE_LWIDTH = 80 


{ Except for the file SDUTPUTs where the default attributes of 
SOUTPUT are used. ) 


If the same file name is used for OUTPUT parameter In several 
GENGF sub _commandss the order of the group statistics will be the 
same as the order of the GENGF sub ucommands. 


The PERMANENT parameter Is a boolean value. If PERMANENT = TRUE» 
then a permanent file with the same name specified in parameter 
QUTPUT will be created under the catalog SUSER. If the permanent 
file is an existing files then a new cycie ( one higher ) will be 
created. The default value of this parameter Is FALSE. 


There are some rastrictions when parameter PERMANENT = TRUE Is 
specifiede 


1. Parameter OUTPUT can not be the default value or $OUTPUT. 


The conflict of the file attributes wit! cause the 
sub u-cemmand to he rejacted. 
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2 Parameter OUTPUT can not be the same as In any previous 
GENERATE. GRDOUPLFILE sub ucommands. The local file name 
confiict will cause the sub command to be rejected. 


3. Parameter ODUTPUT can not be the same as an existing tocal 
file names. The local file name conflict will cause the 
DISPLAY BINARY_LOG to be aborted. 


The PERMANENT paramater is not consistent with NOS/VE philosophys 
and may be removed tin a future update. This wilt not deprive 
users of any functionality. 


Examples: 


CASE 1 ( illegal usage ) 
defy g=open_iInput s=ev190G0 
GENGF g=open_input PERMANENT=TRUE 


CASE 2 ( Illegal usage ) 
defy g=open_input s=evl000 
defg g=close_input s=eviddl 
GENGF g=open_Input OJUTPUT=INPUT_ GROUP 
GENGF g=closa_input OUTPUT=INPUT_ GROUP PERMANENT#TRUE 


CASE 3 € legitimate usage ) 
defg g=open_input s=ev1900 
dafg g=close_input sz=evl901 
GENGF g=open_input OUTPUT=INPUT_GROUP PERMANENT#=TRUE 
SENGF g=close_input OUTPUT=INPUT_ GROUP 


Each stutistic is output as one or more text tines. The first 
fine contains the header Informations Including the number of 
counters and the size of the descriptive data string. The 
counters are output nexts occupying as many lines as necessary» 
The descriptive data string is output f!asts on a single tinea. 
The format of each statistic In the output fille is shown below: 


Line from Che to Ch. Contents 

1 2 3 statistic_identifier 

1 4 9 statistic code 

1 a 17 julian date{ yyyyddd ) 

1 19 30 time({ hhimmiss.emillisecond ) 
1 32 36 job_name 

i 33 45 global _task_id ( nannn-mmm ) 
i 47 68 condensing _ frequency 

1 70 71 number_of_counters 

1 a3 12 descriptive _data_size 

2 1 29 counter 1 ( right justifieds 
2 21 4&0 counter 2 blank filled ) 
2 41 469 counter 3 

2 61 Bd counter 4 

3 1 29 counter 5 

3 3 3 3 
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? 3 3 Fy 
n-1 3) z 2 
n 2 80 descriptive data 


SelleleaS_Ihe QulT_ Sub-cogmand 


This sub-command has no parameters. It ends acceptance of sub-commandss and 
begins processing of the prior sub-commands to generate reports. 


Salle2_IThe_AcIIVATE STATISTIC. Command 


This command is used to astablish and enable one or more statistics to a given 
giobal binary flog. It may be abbreviated as ™"ACTS™. The PDT Is? 


PDT acts _command { 
statistics statisticss s: LIST OF NAME = $REQUIRED 
types ti? KEY statistics statisticss accountings accounts ees 
angineering = statistic 
STATUS ) 


The STATISTIC parameter specifies one or more statistics to be 
established and enabled. Each statistic Is specified as two 
alphabetic characters followed by a decimal number} for examples 
AV260007,. A tist of statisticss enclosed In parenthesis as per 
SCL syntaxs may be specified. 


The TYPE parameter specifies the global binary tog to which the 
specified statistics are to be enabled. Oniy one Jog may be 
specified in each ACTIVATE_LSTATISTIC command. If it is desired 
to sand ao particular statistic to more than one logs multipie 
ACTIVATE_STATISTIC commands may be used. 


4$elle3_Thea_DEACTIVATE STATISTIC Command 


This command is used to disable one or more statistics that had 
previously been enabled to a particular loge All statistics 
remain established, and If they are enabled to another logs that 
connaction remains undisturbed. The command name may be 
abbreviated as DEAS. 
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POT deas_command ( 
statistics statistics» s: LIST SF NAME = SREQUIRED 
types», t: KEY statistics statisticss accountings accounts es 
engineering = statistic 
STATUS ) 


The STATISTIC parameter specifies one or more statistics to be 
disabled. Each statistic is specified as two alphabetic 
characters followed by a decimal number3 for examples AV26C0007. 
A Jist of statisticss anclosed in parenthesis as per SCL syntaxy 
may be specified. 


The TYPE parameter specifies the global binary tog to which the 
specified statistics are to be disabled. nity one log may be 
specified In each DEACTIVATE_STATISTIC command. If it is desired 
to disable a particular statistic from more than one tog» 
multiple DEACTIVATE_STATISTIC commands may be used. 


All statistics specified In the DEACTIVATE_ STATISTIC command must 
have previously been enabled to the specified logs either by an 
ACTIVATE_LSTATISTIC command or by a program Interface call. 


421124. ACTIVATE INTERVAL STATISTIC 


The ACTIVATE_LINTERVAL_STATISTIC (ACTIS) command is used to 
establish and and enable those statistics which are emitted on an 
Interval basis to a to a given giobal binary log. This command 
can only be issued from the system console. 


PNT actis_command ( 
Jms intervals ji: integer 1..999 = 1 
pms_intervatl, pi: Integer 1..999 = 5 
status ) 


The STATISTIC parameter specifies the statistics to be emitted. 
The onty valid statistics of this type currently Is the 08210006 
and 135210001 statistics. 


The JMS_LINTERVAL parameter specifles at what time Interval the 
ims statistic (95216000) should be amitted. The default value is 
1 minute. 


The PMS_LINTERVAL parameter specifies at what time Interval the 


PMS statistic (9$2108061) should be emitted. Thea default value is 
5 minutes. 
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4e1125_ QEACTIVATE_ INTERVAL STATISTIC 
The DEACTIVATE_LINTERVAL_STATISTIC (DEAIS) commmand is used to 
disable interval statistics that have previously been enabled to a particular. 


foge This command only disables the 08210000 and 08210601 statistics. 
This command can only be Issued from the system console. 


POT deals _comnand ( 
status ) 


Sadleo STATLISIICS_ AVaAlLABLe_IN_NOSLVE 


This is a list of the current statistics avallable on NOS/VE. 


STATISTIC NAME COUNTER/DESCRIPTIVE DATA 
AV260909 Accounting CP time C1: Total CP increment 


C2: Job-mode CP time incr. 
C3: Monitor=-mode CP time incr. 


AV260901 Accounting Page Faults Ciz Total page fault incr. 
AY 260902 Accounting working set C1: Current WeS. size 
AV260993 Accounting Ready Tasks Ci: Current ready task count 
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AV260006 Accounting 8egin Accent. OD: 1-31 - account name 


32-33 —- ty 1 
34-64 - project name 


AV 260907 Accounting End Account C1: Totat job SRUts 
$2: Total job CP time. 
AV2609008 Accounting SRU's C1: Totel SRU increment 
CL179900 Display message command DD: String specified in 
command 
CL1T70001 Command names ND: Name of command; upper 


case» 31 characters 


JM1L80000 User name DD: User names; 31 characters 
JM130901 Job name DD: User's job name3; 31 chars 
JM180962 Jodo mode ND: fINTERACTIVE*® or *BATCH*3 


11 characters 


J4189003 Job and C1: CP time — job mode 
C22: CP time - monitor mode 
C3: Page faults 
C4: Page-ins 
C5: Page-reclains 
C6: Page-assigns 


PM 230000 Task beain None 

PM230001 Task Starting Procedure 00: Starting procedure name; 
31 characters 

PM230002 Task name DO: Task name; 31 characters 

24 230903 Task end C1: CP time — job mode 


C2: CP time — monitor mode 
C3: Page faults 

C4: Page-ins 

C53: Page-reclialimns 

C63 Page-assigns 


PM 230904 Loader begin none 
PN2309605 Loader end C1: CP time —- job mode 


C2: CP time — monitor mode 
C3: Page faults 

C4: Page-ins 

C5: Page-reclaims 

C6: Page-assigns 


FO 5800090 Fortran Compilation C1: Task time In compiler 
C2: Monitor time 
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FC580001 


nS 210000 


03210001 


Fortran Program Unit 


JMS-interval 
(job-mamory interval) 


PMS—iInterval 
(paging-monitor interval) 


C32. 
043. 
C53 


DD: 
C1: 
C23. 
C33. 
C42 


C13 
C23 
C33 
C43 
C5: 
C63 
C73 
C83: 
C93 
Cio: 
C1i: 
C12: 
C13: 
C14: 
C153 
C16: 
C173 
C18: 


Ci: 
C23 
C33. 
C43 
C53 
C6: 
C7: 
C8: 
C9: 
C103 
C11: 
C123 
C13: 
C14: 
C15: 
C16: 
C17: 


C18: 


C193 


38 
84/02/10 


No. of lines compiled 
Noe of statements 
Noe of program units 


Program unit name 
Task time for unit 
Monitor time for unit 
No. of tines in unit 
No. of statements 


free pages 
available pages 
availabie modified pages 
wired pages — 
shared pages 
fixed pages 
IG error pages 
job shared pages 
job working set pages 
sSwapped jobs 
ready tasks 
Interactive class 
batch class 
site ctass 06 
site class 1 
site class 2 
site class 3 
maintenance class 


pf available 

pf avallable modified 

pf disk read 

pf new page 

pf tocked 

pf I0 reject 

force aggresive aging 
aggresive aging shared queue 
aggresive aging job queue 
aggresive aging failed 
write aged page 

mr cycle 

mr cycle average duration 
mr delay 

mr delay average duration 
mr wait 

mr walt average duration 
mr write modified pages 
mr write modified pages 
average duration 
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$a12_Accountina/Validation 
The ADMINISTER_LUSER utility can be run from a batch job 
or SCL procedure contrary to what the Family Administrator 


for NOS/VE Usage Manual says. 
PSRs NVEAQD4S and NVEAD46 
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2af_ PRODUCT _SET_NOTES AND CAUTIONS 
3aL.CYBIL 


1) When using DEBUG to breakpoint on a multi-line 
statements the line number supplied to DEBUG must 
be the last line number of the statement. 

CILA498 


2) Cybill prohibits the user from defining an integer 
greater than 48 bits. This has been fixed In the Cycle 
18 compiler version 83333. 
PSR CILAGO9, PSR CILA5S15S 


3) The 256th character of an SCL string varlable cannot be 
set to any character other than a space. This is 
corrected in CYBIL 83333 for Cycle 18. 

PSR CILA634 


5a2-CI8QL 


1) The COBOL READ REVERSE statement does not work. If used» 
It wlll toop iIndefinitely on the first record and never 
take the AT END path. This Is the resuit of BAM failing 
to set the file position to BOI. 

PSR NVOEC44 


2) Two consecutive instances of DPEN OUTPUT on the same indexed 
sequential File will not cause a message warning that the 
data has been evicted by the second OPEN. The user should 
refrain From Issuing another GPEN OUTPUT once the file has 
been created. 

PSR 4A8A196 


2a3_LAPE_120 


1) Tape support Is limited to and intended for use by the 
permanent file backup and restore utility. Use of tape 
I/O for any other purpose may produce undefined results. 


2) Whan preparing to mount a tape to be read by NOS/VEs the heads con 
the drive should first be cleaned. This is recommended before 
each tape mount due to the currently incomplete Implementetion of 
error recoverye 
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sa4 Eile Management Utility 


1) Do not use the File name INPUT In batch mode. It is 
always a null (empty) file with no data In ite. Choose 
a different name. This affects migration 
of jobs from NO5»y where the name INPUT was the job's 
input deck. On NOS/VE use the COLLECTLTEXT command to 
create the Input data. 


2) When using FMU and Inside Interstate Communication 
Facilitys do not do a CLEAR on the EXECUTE_LINTERSTATE 
COMMAND. This will clear FMU checkpoint files and 
render FMU Inoperable. 


225_ED2 TRAN 


1) when using READ (* 2.2) In batch Jobss a File 
containing the desired input must be connected to 
SINPUT by CREATE_LFILE_CONNECTION or equated to INPUT 
on the FIN program statement or LGO statement. 


2) If INPUT or OUTPUT Is opened using an OPEN statement, 
the OPEN statement must be changed to use $INPUT or 
SQUTPUT. 


3) To Insure correct listings and Improve compltation performance 
it is necessary to prevent the Listing file and the errors file 
from belng the same flle. In batch Jobs both would default to 
SOUTPUT. To avoid this set the ERROR parameter on the FORTRAN 
command to a file reference different from that of the LIST 
parameter. 


2ef Advanced Access Methods 
A job using an Indexed sequential fille will fall due to 
entry point errors from the loader. 


The following command executed earlier in the job will 
correct this: 


SETLPROGRAM_LATTRIBUTES TERMINATION ERROR _LEVEL#FATAL 
or SETPA TEL=F 


PSR NVOC941, NVOEZTO 
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58 Soucce Code Jtiilty 


1) The SCU editor command SEARCH BACKWARD will hang if 
asked to locate multiple occurrences of a range of 
text. <A terminate break will stop the hung command 
and allow the user to continue editing. 

PSR SCBAG27 


2) An anomaly can occur when some modifications are 

excluded when a deck Is expanded. An example 
is below? 

Line 1 version 1. 
is introduced by modification A. Modification 8 
replaces this line with 

Line 1 version 2. 
Then modification C in turn replaces this line 
with 

Line 1 version 3. 
If one expands the deck with modification 8 
excluded both the !Iines introduced by modifications 
A and € will appear in the COMPILE fille. 


£29 Product Set_-. DEBUG 


If a job calis a procedure In a lower-numbered ring and 
that procedure causes an errors then Debug does not give 

a proper indication of the problem. Debug reports 

that PM INVALID SEGMENT has cccurred in the user's program 
at the line which originat!y called the (faulty) procedure. 
This situation can occur when a CY8IL program calls an OS 
procedure and the OS procedure does something wrong. 


2a2,0.0n Line Manuals 


Help (also known as EXPLAIN_MESSASE) does not exist In the 
system. 
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6s0_NOS_2222 


The BATCHIO printer driver does not correctly handle tong Lines 
(over 135 characters). The extra characters are elther dropped» 
overprinteds or cause the page to be spaced erraticaily. 

NS2Ci21 
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2eQ8_ECA_LEVELS 


The folowing tables show the microcode and controlware levels that 
were used to validate the NOS/VE system on the specified hardware 
systems supported. These tables show the latest official FCA levels 
of the hardware and microcode and the necessary modifications 
(deviations) required to support the NDOS/VE system. Tables 1» 2, 

39 and 4 correspond to the C170—-815, C17C0-8255 €170-835,» 

CL70-245, and C170-855 systemss respectively. 
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APPENDIX _A_NOSZVE_ PERIPHERAL MAINTENANCE. SUPPORT 
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A129 DEVICE CHARACTERISTICS 


A1.9 DEVICE CHARACTERISTICS 


Alsi DISK_DEVICES 


ALlesle1l PHYSICAL CHARACTERISTICS 


P44~4x B885-l1*x 
Spindles/Cabinet 1 2 
Cylinders/Spindte 823 843 
Tracks/Cylinder 19 40 
Sectors/Track 24 32 
Bytes (8 bit)d/Sector 483 516 


Al.w1.2 LOGICAL CHARACTERISTICS 


Alw1.2ei Terminology 


» Allocation_unit - The quantum of assignment of mass storage 
space to a file. An allocation unit Is a power-of—two multiple 
of consecutive DAUs. At presents, the allocation_unit Is not 
selectabie on a file by file basis; ail end-user files default 
to 16384 byte allocation. 


Device lallocation_unit (DAU) - The quantum of allocation of a 
mass storage volume (spindie). NOS/VE views a davice as an 
array of DAUs which individually or as a contiguous group 
(calied an allocation unit) may be assigned to a mass storage 
file. A DAU consists of an Integral number of MAUs; the ratio 
is device dependent and dependent upon the granulerity of 
allocation NOS/VE can afford to provide for a particuler device. 
A DAU may span tracks but never spans cylinders of a device. 


» Large sector ~- <A controlware capability provided by the 7155 
class of mass storage controller which logically groups four 
physical sectors into one for the purpose of decreasing device 
driver overhead. The term "MAU? is preferable to "large sector! 
since not all controllers may provide this capablility to NOS/VE. 
Note thet a large sector on an 885 device is composed of “four 
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A1l.0 DEVICE CHARACTERISTICS 


AleleZel Terminology 


physicai sectors each of which contains 516 bytes. The last 33 
are not transferred when a physical sector is 


of these bytes 
read in small sector 
ancounter 


NOS/VE wild 


previously antly 


diagnostic is 


accessed 


provided 


mode. 


Therefores 
additional. 
In small. 

verify the 


is possiblie that 


bad=-spots on aie device 
sector mode, The DL38 
data field of a large 


sector. The controlware and NOS/VE consistently report failure 


status in terms of physical 
sactor diagnostics such as PL8 and FLD», 
sector address» 


statuse 


When using the 
recommended that one rely on the sector address in the detattied 


« Minimum_addressable unit 
supported by a PP driver, 


is used to 


Cantral Processor. 


normalize 


Whan 


(MAU) - 


(small) sector address. The large 
howevers display large 


dlagnosticss, it is 


The quantum of data transfer 

The MAU is a software concept which 
the various davice sector sizes for the 
the CP prepares 


requests for mass 


storage devices it thinks In terms of a number of MAUs. The PP 


driver then breaks 


down 


sectoring considerations. 


size which Is not a power of two bytes 
the 


B44—-4x)»y then 


e Page size —- A power of two number 


bytes to 55536 bytes. 
supporting page sizes of 20485 4096» 
constraint is a file system constraint related to adnot wanting 
more than one page per MAU and b) not wanting a page to span 


tracks. 


NOS/VE 


the MAU 


Als1.2.2 NOSZVE_ Disk Volume Allocation 


Sectors/MAU 
MAU/Track 

DAU/Tr ack 
DAU/Cylinder 
NAU/Spindie 

Bytes /MAU 
Bytes/Track (avge) 
Bytes/Cyliinder 
10**6 Bytes/Spindie 
10%**5 Bytes/Segment 


844~4x 


5 
4.8 
204 

44 
37035 
2048 
948544 
180224 
151.6 
2147.5 


885-1~x 


4 
8 

4 

169 
134889 
2048 
16384 
655360 
552645 
214725 


of 
is 


physical address and 
If amass storage device has a sector 
In length (such as the 
MAU will begin at the start of a sector and 
finish in the midst of the last sector; 
spanned is device dependent. 
spans cylinders of a device. 


number of sectors 


An MAU) may span tracks but never 


ranging from 512 


presently constrained to 
8192 and 16384 bytes. The 


~ COMPANY PRIVATE - 


Al=-3 
SOFTWARE RELEASE BULLETIN 
84/62/16 
NMOS/7VE (CYCLE 17) 
A1l.0 DEVICE CHARACTERISTICS 
Alele2e2 NOS/VE Disk Volume Allocation 


Ale1.2.3 NOS/VE_Elia Allocation 


Allocation Unit Size: 844—4x RB5—1*x 
(Consecutive DAUs) (bytes) {bytes) 
1 49096 4096 
2 8192 8192 
4 16384 16384 
8 32768 32768 
16 65536 65536 
32 131972 1321072 
64 180224 262144 
128 180224 524288 
256 130224 655360 


AL.2 TAPE DEVICES 


Ale2el PHYSICAL CHARACTERISTICS 


AL.2.2 LOGICAL CHAPRACTERTSTICS 
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A200 MASS STORAGE VOLUME MANAGEMENT 


Hass STORAGE VOLUME MANAGEMENT 


A2el SYSTEM_ INSTALLATION PREPARATION 


AZelei PREPARING 844 AND 885 DEVICES 


Ali 844 and 885 volumes are formatted at the factory. Neither 844 
nor 885 volumes need to be reformatted to be used by NOS/VE. Volumes 
used by NOS are Interchangeable with NOS/VYE without re-formatting. 
Utility Map processing Is identical in all aspects. Howevers with the 
exception of the Factory Map and the Utility Maps the data recorded on 
a volume by NOS cannot be interchanged with NOS/VE and vice versa. 


NOS/VE does not honor the CTI deadstart sector content. Therefore 
it doas no good to install CTI or CML on a NOS/VE device nor can one 
expect this information to remain Intact across mixed system use of 
the devices e.g. first NOS» then NOS/VE and then NOS again. CTI and 
CML should only be Installed on the NOS deadstart device or an 
giternate device used only by NOS. 


Prior to attempting NOS/VE system installations the following 
procedures should be performed alther on-tine using MALET on NOS or 
off-ftine using DEMOT. The objective of these procedures is to ensure 
the correctness of the Utility Map maintained on each davice.e The 
INITIALIZE_MS_ VOLUME process described later uses the Utility Map to 
avoid defects (bad-spots) on the disk surface. 


A2elsl.l Systen Deadstart Device 


ae For the NOS/VE system deadstart device it is recommended that 
the SCAN DISPLAY FLAWS module of the FMU dlagnostic be used to 
display all the sectors which have track or sector flaws set. 
This display must then be compared to the display of the Utility 
Map. Any flawed sectors not In the Utility Map must be added to 
ensure that the Installation of the NOS/VE system will go 
smoothiy. This procedure should be axpected to take at least 10 
minutese Refer to the discussion of defect management below for 
further insight as to why the above procedure is recommended. 
be Use the OL8 diagnostic to write/read large sectors on Cylinder 
O» Track 0 of an 885 deadstart device, This accomplishes two 
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A2elelel System Deadstart Device 


things: 1) it proves that track C can fater be written by 


INITIALIZE_LMS_VOLUME (INIMV) 2) It ensures that fictitious 


unrecovered checksum Fallures are not encountered by INIMV when 
performing NOS/VE tabeli searching. Note that it is totally 
unnecessary to write large sacters on the whole device because 
NOS/VE never reads a sector that it has not first written 
{except during INIMV label searching). 


A2e1.1.2 Volumes Dther Than the System Deadstart Device 


The above procedure is strongly recommended for each mass storage 
device to be used by NOS/VE. 


A2e2 INITIALIZE _MS_ VOLUME 


A2e2e1 INITIALIZATION OF 844 AND 885 VOLUMES 


The INITIALIZE _MS_ VOLUME C(INIMY) subcommand of the Logical 
Configuration Utility (LOU) is used during the NOS/VE installation 
process to prepare mass storage votumes for use by NOS/VE. The 
Initialization includes writing a NOS/VE software tabel on the votume 
and processing the Utility Map located on the volume itself. Before 
proceeding with the initialization of the volumes» INIMV attempts to 
read a NOS/VE tlabel from one of three possible locations on the 
volume: MAUS l» 2 and 3 are tried In succession. This is done as a 
protection against operator error which could destroy files on the 
volume if re-initialized. 


If an 885 volume has not been previously Initiallzed by NOS/VE or 
has not been written in large sector mode by diagnostic softwares then 
an uncorrected checkword fallure will be reported for each of the 
three attempts made by INIMV to read a NOS/VE label. Under the 
previously stated conditionss the reporting of these 3 failures is 
expected and should pot be a source of concern. The 3 locations read 
by INIMVs in the order attempteds are? 

1eCylinder 9» Track O» Sector 9 
2eCylinder O» Track O» Sector 4 
3eCylinder 0» Track O» Sector 83 (10 octal) 


Mote that for an 844 davices checkword faiiures are pot expected 
during INIMV ltabel checking. 
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A2s2el INITIALIZATION OF 944 AND 885 VOLUMES 


Onee convinced that It is not destroying files by mistakes INIMV 
proceeds to write a NOS/VE label on the volume. Next it processes the 
Utility Map recorded on the volume. The location of the Utility Map 
is device dependent as Is the content of the map.» However the manner 
in which tha Utility Map is read by the NOS/VE driver is device 
Independent as Pollows? 


The 844 and BAS Utility Maps are written in small sector format by 
the factory and by diagnostic utilities, The Utility Maps fall 
somewhere within a NOS/VE MAU (logice!l sector of 2048 bytes). The 
driver Is given an MAU ordinal by INIMV and the driver attempts to 
deliver an MAU. This involves reading elther 4 or 5 small sectors 
depending upon the device. Because some of the sectors have been 
write—-protected by the controller and some have not the driver 
attempts to read each small sector usina the following saquence of 
commands: 


1.Read protected sector (34) 

Z2eRead (4) 

3.Read factory data (30) 

4.Read utility map (31) 
If an address error Is returned for a particular sector the next read 
function is tried for the same sector until allt 4 generic read 
functions have been triad or the read is successful» whichever occurs 
first. Intervenlng address error fallures are not reporteds onty the 
fast of the four. <Any failure other than an address error detected 
after any of the four generic reads causes request termination and is 
reported, 


AZe2elei 844 _Utllity Map Processing 


The INTIALIZE_MS_VOLUME subcommand uses the Utility Map located at 
Cylinder 822» Track OG» Sector 2 to flaw defects which have been 
detected at the factory or by the CE and recorded in the Utility Map. 


The Utility Map ts an array of 90 ». 161 fiew entries. Each entry 
documents either a track fiaw or a sector flaw. Sector flaws are 
recorded in the physical (smal!) sector nunbering scheme. 


INIMV logically flaws the DAU affected by a sector flaw and the 3 
DAUS affected by a track flaw. Note that because of the data mapping 
of the 844 device a track flaw will also logically flaw from © to 4 
smal f sectors on the next track. 

To support diagnostic use of the devices INIMV also flaws cylinders 
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A2e2ele2 885 _ Utility Map Processing 


The INITIALIZE _MS_ VOLUME subcommand uses the Utility Map ftocated at 
Cyttnder 841, Track lL», Sector 1 to flaw defects which have been 
recorded there by the factory or by a CE. 


The Utility Map Is an array of 0 «2+ 161 Piaw entries. Each entry 
documents a track Flaw. 


INIMV togically flaws the 4 DAUs which are affected by a flawed 
tracke 


To support diagnostic use of thea davicays INIMV fiaws cytinders 
844528426 


A2.3 VOLUME DEFECT MANAGEMENT 


A2e3e1 RECOMMENDATIONS FOR 3844 AND 885 DEVICES 


Qnce NOS/VE has been installed and all of its mass storage volumes — 


have been initializads It Is possible that additional defects wilt! 
appear on the surface of a volume. 


The sympton of this defect is likely to initially be a recovered 
read/write fallure. If the same sector Js reported repeatediys one 
may wish to take action to avoid the loss of performance incurred by 
repeated disk driver recovery attemots. The SAVE DATA and RESTORE 
DATA capabilities of the FMU diagnostic utility may be used to 
relocate the failing sector. This capability oniy appties to 885 
devices as these devices provide two spare sectors per track for this 
purpose, The procedure must be performed off—line to NOS/VE. Refer 
to the discussion of off-line flawing for further Information. 


If the symptom of the defect Is an unrecovered read failures the 
recommended procedure is to delete the file to which the failing 
sector was allocated. The deletion of the file should only be done 
after repeated attempts to read the fite have all failed. It is 
possible t<<<<<K< 
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